home *** CD-ROM | disk | FTP | other *** search
/ CD Exchange / CD Exchange - Volume 1.iso / utils / disk / fastdir / fastdir.doc < prev    next >
Encoding:
Text File  |  1992-05-13  |  8.5 KB  |  252 lines
  1. FastDir V1.13 Manual :
  2. ======================
  3.  
  4. Copyright:
  5. ----------
  6. (c) 1991 Alexander Rawass
  7.  
  8. Alexander Rawass
  9. Wilhelminenstraße 44
  10. 6700 Ludwigshafen 15
  11. Germany
  12. 0621/57 75 98
  13.  
  14. E-Mail : rawass@sun.rhrk.uni-kl.de
  15.  
  16.  
  17. This (and all other) version of FastDir is ShareWare.
  18. That means, the author allows the free spreading, copying and distribution
  19. of FastDir, as long as no profit is made for the distributor.
  20.  
  21. The program remains copyright by the author (Alexander Rawass).
  22. The author keeps all rights on the source code, the executable program and
  23. on the documentation.
  24.  
  25. If you use FastDir regularly, you have to pay the ShareWare-fee to the
  26. author, or else you are illegally using FastDir.
  27.  
  28. This version of FastDir is a 'crippled' version, it will work only on disks
  29. inserted in floppy-drive DF0.
  30.  
  31.  
  32. You have to send the ShareWare-fee of DM 20 (Deutschmark) or US$ 15 to the
  33. above address.
  34. If you pay the ShareWare-fee, you will get a full-working version of
  35. FastDir (which supports disks in all four drives), and you will also receive
  36. the newest versions of FastDir per disk.
  37. Additionally, you'll also get a special 'FastDirHD', which will not only
  38. speed up directory access on your floppy-disk-drives, but also directory
  39. access on all devices which support either the old filing system or the new
  40. FastFileSystem (that are for example : the ASDG-ram-disk, RAD:, MS0:
  41. (messydisk.device), DS0: (mfm.device), and (of course) all harddisk-devices
  42. available at the moment.
  43.  
  44.  
  45. I.    What is FastDir                    line
  46. II.    What you need for FastDir            line
  47. III.    Description of FastDirs gadgets            line
  48. IV.    New Gadgets and Options since FastDir 3.18    line
  49. V.    Configurating FastDir on startup        line
  50. VI.    Working with FastDir                line
  51. VII.    Paying your ShareWare-Fee            line
  52. VIII.    Distribution                    line
  53. IX.    PostScriptum                    line
  54.  
  55.  
  56. What is FastDir?
  57. ----------------
  58. FastDir is a small but very powerful system patch.
  59. FastDir will speed up directory access by a factor of two upto ten,
  60. depending on the scattering of the file structure on your disk.
  61.  
  62. By the way FastDir works, it is usable with every normal Amiga-program,
  63. which uses the internal Dos-routines to scan the directoy.
  64. That are nearly all multitaskig programs!.
  65.  
  66. With FastDir, you don't have to use disk-optimizers to speed up directory
  67. access, you just install the patch in your system by calling the program,
  68. and then directory access will speed up with every directory on every disk
  69. you have.
  70.  
  71.  
  72. How to use FastDir
  73. ------------------
  74. FastDir has to be run from CLI. Of course, you can also start it from
  75. workbench with the help of IconX or something else.
  76. You would be advised best to put FastDir in your startup-sequence.
  77. You don't have to use 'run' to start FastDir, because FastDir will
  78. automatically detach itself from CLI.
  79.  
  80. Usage:
  81.  
  82. fastdir        : will start FastDir and will install the system patch in
  83.           your Amiga
  84.           if FastDir is already installed, it will print out an
  85.           error message
  86. fastdir remove    : this option will remove FastDir from the system
  87.           if FastDir is not installed yet, an error message will be
  88.           printed
  89.  
  90.  
  91. How does FastDir work?
  92. ----------------------
  93. Well - this is my personal secret!
  94.  
  95. I will only reveal this :
  96.  
  97.     Every time the Dos-function Examine() is called, the directory
  98.     header of the specified directoy is read in, and all the entries
  99.     in this list are sorted in numerical order, with the lowest block
  100.     as the first to be read in and the block with the highest number
  101.     as the last to be scanned.
  102.  
  103.     Every time ExNext() is called, the additional block numbers read
  104.     are inserted in this sorted list.
  105.     
  106.     This way, the directoy scan routine has been highly optimized and
  107.     directory scanning is speed up.
  108.  
  109. If you want to see how FastDir works, just try a
  110.  
  111.     list <directory> keys
  112.  
  113. on a very long directoy. You will see that without FastDir on an
  114. unoptimized disk, the block numbers will go up and down, while with FastDir
  115. installed, the block numbers should increase most of the time.
  116.  
  117.  
  118. But anyway - you don't have to know how FastDir works to be able to use it
  119. - using it is so simple, just call it!
  120.  
  121. Invoke FastDir by typing 'FastDir' in your command line, and then try a few
  122. disks and time how long it takes to scan the directory.
  123. Then, type 'FastDir remove', get the time how long it takes to scan the
  124. directories now, and you will see how FastDir will speed up directory
  125. access.
  126.  
  127.  
  128. Guarantee
  129. ---------
  130. none.
  131. If your Amiga takes a trip to India while using FastDir, so all I can say is
  132. 'bad luck'. Send me a letter or write me via e-mail and describe the bug as
  133. clearly as possible (bug? which bug? no bugs! :-)
  134.  
  135.  
  136. Combat-i-bility
  137. ---------------
  138.  
  139. FastDir will work on Amigas with Kickstart 1.2, 1.3 or 2.0.
  140.  
  141. The following devices are accessed faster :
  142.     DF0, DF1, DF2, DF3
  143. all other devices (RAM, RAD, DH0, JH0, VD0, DI0, MSH, etc.) are accessed
  144. slower (I mean as slow as ever).
  145. (This is only correct for the registrated version of FastDir, the crippled
  146. ShareWare-version works only with DF0).
  147.  
  148. The additionally available 'FastDirHD' will work not only with DF0-DF3, but
  149. also with every harddisk and every other device which works with the old
  150. filesystem or the new FastFileSystem.
  151.  
  152. FastDir will work with every program, with every file-requester, with every
  153. CLI or workbench utility I can imagine.
  154.  
  155. BUT ... FastDir will NOT work with the standard CLI commands supplied with
  156. Kickstart 1.2 (and I think Kick 1.3, too).
  157. These CLI commands are not programmed like Amiga programs should be.
  158. They were written not in C, but in BCPL, and so they don't jump over the
  159. vector-table of the dos.library, but use an internal 'Dos shared global
  160. vector', which is not patched by FastDir.
  161. Programming in BCPL and jumping this way is strictly illegal and highly
  162. immoral and should not be done on the Amiga.
  163. So throw these commands away and use the commands of the arp.library
  164. instead.
  165.  
  166. Using FastDir can bring problems if you are using other system patches
  167. which use the ExNext, Lock, Examine or UnLock routines from the
  168. dos.library.
  169. If you get system crashes, try to start FastDir *after* you have started
  170. the other patches - FastDir will recognize that there are other patches in
  171. the system and will change the vectors properly - other patches (like the
  172. old version of 'pp') are not so good programmed.
  173.  
  174.  
  175.  
  176. Paying your ShareWare-Fee
  177. -------------------------
  178.  
  179. This is very very important!
  180. Using FastDir regularly without paying is both illegal and immoral!
  181. And, of course, as a registered user you will receive the latest,
  182. uncrippled version of FastDir as fast as possible.
  183.  
  184. Send the money (either DM 20 if you live in Europe, or either US$ 15 if you
  185. live in the states or elsewhere in the world (I'll take no yen, of course))
  186. to :
  187.  
  188.     Alexander Rawass, Wilhelminenstr.44, 6700 Ludwigshafen, Germany
  189.  
  190. Bug comments and ideas for improvement are also welcome. Send them to :
  191.  
  192.     rawass@sun.rhrk.uni-kl.de
  193.  
  194. Don't forget to include your own address with the letter, or you will
  195. receive absolutely nothing!
  196.  
  197.  
  198. Distribution
  199. ------------
  200.  
  201. FastDir is freely distributable ShareWare.
  202.  
  203. You can copy it as you want, as long as you make no profit from copying.
  204. This means, a disk with FastDir on it should not cost more than ca. 3 DM,
  205. which is about US$ 3.
  206.  
  207. It would be great if FastDir would be included on some FD-series, like
  208. Fish, TBAG, Franz, AUGE, Tornado, etc.
  209.  
  210. Spread FastDir as you can, push it in every FTP-server and in every net
  211. you can find, put it in your local mailbox and be happy with it.
  212.  
  213. But, of course, you may only distribute the COMPLETE FastDir.
  214. FastDir consists of the following files :
  215.  
  216.     FastDir            - the program
  217.     FastDir.Doc        - this documentation
  218.     FastDir.ReadMe        - a short readme file
  219.     FastDir.Vertrieb    - for german eyes only
  220.     FastDir.*.info        - some .info files which give nice icons
  221.  
  222. If any of the files are missing, FastDir may no longer be distributed!
  223.  
  224. German distributors, read FastDir.Vertrieb!
  225.  
  226. If one of the files is missing or is corrupt, or if you want to get the
  227. newest version of FastDir, you should take a look at the following
  228. anonymous FTP-servers :
  229.  
  230.     ftp.uni-kl.de
  231.     ab20.larc.nasa.gov
  232.     amiga.physik.unizh.ch
  233.  
  234.  
  235. PostScriptum
  236. ------------
  237.  
  238. I am not responsible for anything that happens if or when you use
  239. FastDir or not.
  240. I am not responsible for any sort of virus, computer crashs, hardware
  241. explosion or a blow-up printer.
  242. I am not responsible for the second world war, neither will I be
  243. responsible for the next to come.
  244.  
  245. I am not Shakespeare or Hemingway, so please forgive me my bad writing, my
  246. writing errors and my *bad* documentation.
  247. Next time I'll try better :-)
  248.  
  249.  
  250. If you know of *any* Internet Mailboxes in Germany, Switzerland or Austria,
  251. please send e-mail to : rawass@sun.rhrk.uni-kl.de
  252.